═══ 1. Introduction ═══ Welcome to the FTP-It! User's Guide! ═══ 1.1. What is FTP-It! ? ═══ FTP-It! is a 32-bit, multi-threaded FTP Client application for OS/2. With FTP-It! you can connect to and interact with multiple remote FTP servers concurrently. Files and directories on each host are presented in separate, resizeable windows. Since each host window executes on it's own OS/2 thread, parallel file and directory events are possible. FTP-It! complies with RFC 959, 1123 and 1579 specifications of the File Transfer Protocol (FTP). The FTP-It! GUI is written in REXX, using Watcom VX-REXX. A C language DLL provides the TCP/IP services for FTP-It!. Thank you for trying FTP-It!. We hope you will find it a useful tool. ═══ 1.2. Features ═══ Some of the features of FTP-It! are - Separate, resizable windows for all hosts - Multi-threading to allow parallel file and directory events on all hosts - File and directory display in a easy-to-use, customizable format - File transfer progress, including byte count and time estimate - Capability to abort a connect or an active file transfer - Rename and delete files, and create and delete directories on all hosts - Remote host command window - Print local files - Automatically browse a file downloaded from a remote host - Multiple file select for delete, rename and transfer - Drag-and-drop file transfer, delete, and local file print - File list caching for improved client and server performance - Individual settings notebook for all hosts ═══ 1.3. Requirements ═══ These are minimum requirements to run FTP_It!: - OS/2 V2.x, V3 WARP, V3 WARP Connect - Internet Access Kit, TCP/IP V2.0, TCP/IP V3.0 - Watcom VX-REXX runtime DLL (Version 2.13 is provided) - LAN or dialup access to the Internet ═══ 1.4. What's New In This Release ═══ See Release Information for details. ═══ 1.5. Shareware Restrictions ═══ There aren't any. This version of FTP-It! is fully-functional. However, until registered, it is an evaluation copy subject to an evaluation period. The evaluation period begins with the first execution and lasts for 14 days. At the end of the evaluation period, you must register FTP-It! if you want to continue to use it. ═══ 2. Ordering and Registration ═══ FTP-It! can be ordered from BMT Micro, and the current release will be shipped on 3.5" diskette. FTP-It! can also be downloaded from the public area of many of the popular FTP sites. The file name is ftpit211.exe and it is a self-extracting Info-ZIP of the installation files. To order or register FTP-It! 1. Contact BMT Micro. You will receive your registration password within 24 hours 2. Start FTP-It! and wait for the Local Host window 3. Click the 'Register' pushbutton 4. Type your registration password and press ENTER That's all that there is to it! ═══ 2.1. How To Contact BMT Micro ═══ BMT Micro can be contacted in several ways. - Telephone: 9:00am - 7:00pm EST (-5 GMT) (800) 414-4268 (orders only) (910) 791-7052 - Mail Orders: BMT Micro 2515C South 17th St. Wilmington, NC 28401 U.S.A. - Fax Orders: (910) 350-2937 24 hours / 7 Days - Online Orders via modem: (910) 350-8061 10 lines, all 14.4K (910) 799-0923 Direct 28.8K line - Ordering and general ordering questions: via AOL: bmtmicro via Compuserve: Thomas Bradford, 74031,307 via Internet: thomas.bradford@bmtmicro.com BMT Micro accepts Visa, Mastercard, Discover, American Express, Money Order, Cashiers Check, Personal Check. Please do not send cash in the mail. Personal checks are subject to clearance. ═══ 3. Installation ═══ FTP-It! can be installed from either of two sources - The product diskette, available from BMT Micro - The installation zip, ftpit211.exe , that you can download from many of the popular FTP sites If installing from the product diskette 1. Stop FTP-It! if it is running 2. Insert the product diskette in drive A: 3. Open an OS/2 command window 4. Type a: and press ENTER 5. Type install and press ENTER It is IMPORTANT to enter 'a:' and 'install' as separate commands PLEASE DO NOT ENTER a:install If installing FTP-It! from the installation ZIP that has been downloaded into the temporary directory C:\TEMP 1. Stop FTP-It! if it is running 2. Open an OS/2 command window 3. Type c: and press ENTER 4. Type cd \temp and press ENTER 5. Type ftpit211 and press ENTER to extract the installation files from the ZIP 6. Type install and press ENTER ═══ 3.1. Running INSTALL.EXE ═══ At this point you should be looking at the FTP-It! Installation window 1. Click 'Actions' and then 'Install product', or press and hold CTRL and press i 2. Wait for the Installation directory window 3. Change the destination drive and/or directory if you want to - Please don't change anything but the destination drive and/or directory 4. Press ENTER 5. Verify the location of the installation files is correct, and change if necessary 6. Press ENTER and wait for installation to complete 7. Press and hold ALT and press F4 to close the installation program ═══ 3.2. Advanced Installation Topics ═══ This section contains information for experienced users. ═══ 3.2.1. Rebuild FTP-It! Desktop Objects ═══ To rebuild the VTR APPS Desktop folder and the FTP-It! icons 1. Follow the installation instructions until you see the Installation directory window 2. Click 'Copy product files' to deselect it 3. Click 'Continue' or press ENTER 4. Wait for the installation program to complete, then close it ═══ 3.2.2. If You Already Have VROBJ.DLL ═══ The VX-REXX runtime, VROBJ.DLL, is distributed with FTP-It!. If you have installed VX-REXX or another product that uses VX-REXX, you will already have VROBJ.DLL on your machine. If you would like to save some disk space 1. Locate the other copy of VROBJ.DLL and ensure that it is - Version 2.13 or greater, AND - In a directory defined as a LIBPATH in CONFIG.SYS 2. Delete VROBJ.DLL from the FTP-It! target directory If FTP-IT! is used with a version of VROBJ.DLL that is older than v2.13, VX-REXX will warn you about a version mismatch when FTP-It! is started. There are no known problems with FTP-It! and version 2.12 of VROBJ.DLL. No other combination has been tested. VROBJ.DLL is also distributed with OS/2 Warp Connect. It is installed in the GRPWARE directory. ═══ 3.2.3. If You Re-Install OS/2 ═══ If the OS2.INI file is rebuilt, either by re-installing OS/2 or by running MAKEINI, you will have to re-register FTP-It!. ═══ 4. Getting Started ═══ In the sections that follow are examples of using some of the basic FTP-It! capabilities. The examples, from start to finish, will show you how to - Setup default logon parameters - Logon to a remote host - Change the remote host display to another directory - Download a remote host file to your workstation - Close the remote host connection Each example assumes that you have followed the preceding examples. The first step is to locate the VTR Apps folder on the Desktop, open it and double-click the FTP-It! icon. If you haven't registered FTP-It!, you will see the shareware evaluation reminder window first. You must click 'OK' or press ENTER to continue. ═══ 4.1. Setup Default Logon Parameters ═══ NOTE: A default userid of anonymous and password of your e-mail address are very handy, but not required. This example assumes that you will want these defaults. From the Local Host window 1. Open the local host settings notebook - Click 'Options' and then 'Settings', or press and hold CTRL and press n 2. Click the 'Options' tab 3. Enter your e-mail address in the indicated entryfield 4. Click the 'Logon' tab 5. Select the host named .DEFAULT from the host name list - Click the down arrow to the right of the host entryfield to see the list of names 6. Note the default Userid is anonymous 7. Note the default Password is ******. It's really &email, it's just masked 8. Close the local host settings notebook ═══ 4.2. Logon To A Remote Host ═══ This example will show you how to connect to the hobbes FTP site. You can use another remote host if you would prefer. From the Local Host window 1. Click the 'Logon' pushbutton, or press and hold CTRL and press L 2. Wait for the Remote Logon window 3. Type hobbes.nmsu.edu into the Host entryfield 4. Note your default userid and password in their respective entryfields (Guess you'll have to trust us about that line of asterisks in the password field) 5. Click 'Logon' or press ENTER The password in this example was &email. FTP-It! substituted your e-mail address for this symbolic and then tried to connect to hobbes. You can use this symbolic for a password anytime. If the logon fails for some reason (like too many anonymous users), you will see a window displaying the last message received from hobbes and asking if you want to retry - Click 'Yes' or press ENTER to retry the logon up to 5 times, or - Click 'No' or press ESC to return to the Remote Logon window, or - Click 'Messages' to see all of the messages generated by hobbes When you are connected to hobbes, you will see the remote host window with the title anonymous@hobbes.nmsu.edu ═══ 4.3. Change The Remote Host Directory ═══ On the anonymous@hobbes.nmsu.edu window - Double-click an item in the directory listbox. os2 is a good choice because there are normally files in that one The display will be updated with the contents of the selected directory. Now, note the .. item in the directory listbox. Double-click that item now and the display will return to the parent directory. Also note that a file list was not received this time and the display was updated much faster because the parent directory list was cached the first time you saw it. Another way to move back up in the current directory tree is by using the directory tree drop-down list 1. Click the down arrow to the right of the directory name to see the list 2. Click the branch of the tree that you want to return to If you like typing, press and hold CTRL and press c and you'll be prompted for the new directory name. Or, click the directory list with the RMB and you'll get a pop-up menu of directory actions. ═══ 4.4. Download Remote File ═══ On the anonymous@hobbes.nmsu.edu window - Double-click an item in the file listbox You will see the Send File To Local confirmation window which contains - The fully-qualified name of the remote file to be downloaded - The target directory on your workstation - The file name to be stored in that directory - The transfer type and Browse option You can change all of the above except the remote file name. Click 'Send' or press ENTER to start the file transfer. The file transfer progress window will become visible. When it goes away the file has been transferred to your workstation. To transfer more than one file - Hold the LMB down and drag it over the file items you want to select, or press and hold CTRL and click each file item individually - Click 'Send', or press ENTER, or double-click the file listbox You will see the Send File To Local window again. Each time you click 'Send' that file transfer will be scheduled and the next file will be presented for confirmation. If you decide to skip a file, click 'Next'. If you want to confirm all of the remaining files at once, click 'All'. When the first file transfer starts, the file transfer progress window will become visible. When it goes away, all of the files have been transferred to your workstation. ═══ 4.5. Download Remote File - Drag And Drop ═══ On the anonymous@hobbes.nmsu.edu window 1. Make sure the Ascii/Binary setting is correct 2. Grab a file item with the RMB 3. Drag it to the Local Host window 4. Drop it on - A directory list item to transfer to that directory - A 'blank spot' in the directory list or the file list to transfer to the current directory Drag and drop transfers are NOT confirmed. When the file is dropped, file transfer starts and the progress window becomes visible. When it goes away the file has been transferred to your workstation. ═══ 4.6. Logoff And Disconnect From A Remote Host ═══ On the anonymous@hobbes.nmsu.edu window - Click 'Logoff', or - Press and hold CTRL and press o, or - Just press F3 ═══ 5. Settings Notebooks ═══ There is a settings notebook for the local host and for each remote host that has been successfully connected. To open a settings notebook - Click 'Options' and then click 'Settings', or - Press and hold CTRL and press N ═══ 5.1. Local Host Notebook ═══ In the local host notebook you can customize - Settings for the Local Host window - Default settings for remote host windows - Default Logon parameters and options - FTP-It! options ═══ 5.1.1. Local Window Settings ═══ The Local Host window settings are found under the Local tab. In this section you can - Customize the file list by adding or removing file length and/or timestamp to the display - Change the file list sort direction - Enable or disable confirmation of certain events - Specify an output directory for files transferred from a remote host to your workstation - Control automatic refresh of the local host window ═══ 5.1.2. Default Remote Host Window Settings ═══ The default remote window settings are found under the Remote tab. The settings in this section are used the first time you connect to a given remote host and are similar to the Local Host Window Settings. After the first connect to a given remote host, the window settings are customized in the Remote Host notebook. ═══ 5.1.3. Default Logon Parameters ═══ Default logon parameters for remote hosts can be created and changed in the Logon section of the local host notebook. For each host you can specify - User id - Password - Account - Initial directory to be displayed in the remote host window - File name pattern, like *.zip, to restrict the file names displayed The logon parameters are automatically entered into the entryfields of the Remote Logon window when you enter the host's name. The parameters for the host named .DEFAULT are used when no other parameters are available, like when you try to connect to a given remote host the very first time. Specify &email as the password to use your e-mail address from the 'Options' section of the local host notebook. Note that setting the .DEFAULT userid to anonymous and password to &email is very handy. ═══ 5.1.4. FTP-It! Options ═══ The Options section of the local host notebook contains general FTP-It! options, including - Start a Remote Logon window when FTP-It! starts - Specify the remote logon retry count ═══ 5.2. Remote Host Notebook ═══ The remote host notebook contains the same window controls as in the Local section of the local host notebook. There are additional controls, such as - Enable or disable file list caching - Establish a time limit for cached file lists - Specify an output directory for files transferred from this host to your workstation. This directory overrides the default output directory setting in the local host notebook. Remote host settings are initially as specified in the Remote section of the local host notebook. There is a unique settings notebook for each remote host that has been connected. You must be connected to a host to open its settings notebook. ═══ 6. File Transfer ═══ With FTP-It!, you 'send' files between hosts. A file transfer is initiated on the 'from', or source, host window - A 'send' request on a remote host window is an FTP GET; files are transferred from remote to local - A 'send' request on the local host window is an FTP PUT; files are transferred from local to remote ═══ 6.1. Default Output Directory ═══ Each host, local and remote, has a default output directory associated with it. FTP-It! will send files to this directory unless you override it in the file transfer confirmation dialog. The directory is specified in the host's settings notebook and can be - The directory currently displayed in the target host's window, or - A specific directory on the target host system Each remote host can also have a target directory on your workstation for files that are downloaded from that host. This directory overrides the output directory setting on the local host. The default setting for output directories is to use the directory that is currently displayed in the target host's window. Note that you cannot change the output directory from the setting if - File transfer confirmation is disabled, or - Drag-and-drop file transfer is used ═══ 6.2. Confirmation ═══ By default, file transfer requests are confirmed. The confirmation dialog allows you to change the output directory, output filename and transfer type for each file being transferred. In addition, file transfer confirmation on the local host allows you to select the target remote host. Because the local host can have more than one target the dialog operates a little differently than on the remote host o Local Host - The 'Send' pushbutton schedules a file transfer with the selected remote host - The same file can be sent to another remote host by selecting a different host from the list and clicking 'Send' again - The 'Next' pushbutton must be clicked to present the next file to be transferred o Remote Host - The 'Send' pushbutton schedules a file transfer with the local host and presents the next file to be transferred If you change the output directory and/or the transfer type on the confirmation window, the changes apply to all requests not yet confirmed that have the same target host. File transfer confirmation can be disabled in the settings notebook for the host. File transfers that are initiated by drag-and-drop are NOT confirmed. ═══ 6.3. Default Host ═══ When connected to more than one remote host, you can designate one as the default target for uploads by 1. Clicking 'Connect' on the Local Host window 2. Clicking 'Default Host' 3. Clicking the desired remote host The default host is reset when - You logoff of that host, or - You reset the choice by pressing and holding CTRL and pressing z on the Local Host window When a remote host has been selected as the default, that host is pre-selected in the file transfer confirmation window. If confirmation is disabled, files are transferred to this host only. When connected to more than one remote host WITHOUT a designated default, file transfer confirmation cannot be disabled because it is in the confirmation dialog that you select the target host. ═══ 7. Hot Keys ═══ This section describes the keyboard shortcuts that are defined on the FTP-It! windows. ═══ 7.1. Local and Remote Host ═══ File List Control. Changes to the file list made with these keys are not recorded in the settings notebook. ┌────────────┬─────────────────────────────────────────────┬──────┬──────┐ │Key │Function │Local │Remote│ │ │ │Host │Host │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+P │File list in FTP-IT! format │ │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+S │File size in file list toggle │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+T │File timestamp in file list toggle │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+U │File list in remote host format │ │X │ └────────────┴─────────────────────────────────────────────┴──────┴──────┘ ┌────────────┬─────────────────────────────────────────────┬──────┬──────┐ │ALT+SHIFT+A │Sort file list in ascending order │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │ALT+SHIFT+D │Sort file list in descending order │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │ALT+SHIFT+E │Sort file list by extension │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │ALT+SHIFT+N │Sort file list by name │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │ALT+SHIFT+S │Sort file list by size │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │ALT+SHIFT+T │Sort file list by timestamp │X │X │ └────────────┴─────────────────────────────────────────────┴──────┴──────┘ Other Functions ┌────────────┬─────────────────────────────────────────────┬──────┬──────┐ │Key │Function │Local │Remote│ │ │ │Host │Host │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+A │Ascii/Binary toggle │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+B │Browse file │X │ │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+C │Change directory │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+D │Delete file │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+H │Switch to Local Host window │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+I │FTP-It! version information │X │ │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │ │Remote connection information │ │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+L │Logon remote host │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+M │Make directory │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+N │Open settings notebook │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+O │Close Remote Host window │ │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+P │Print file │X │ │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+Q │Send command to host (Quote) │ │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+R │Rename file │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+V │Restore the file browser window │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+X │Restore the file transfer progress window │ │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │CTRL+Z │Reset default remote host │X │ │ └────────────┴─────────────────────────────────────────────┴──────┴──────┘ ┌────────────┬─────────────────────────────────────────────┬──────┬──────┐ │ENTER │Transfer file │X │X │ └────────────┴─────────────────────────────────────────────┴──────┴──────┘ ┌────────────┬─────────────────────────────────────────────┬──────┬──────┐ │F1 │Open FTP-It! User's Guide │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │F3 │Close host window │X │X │ ├────────────┼─────────────────────────────────────────────┼──────┼──────┤ │F5 │Refresh display │X │X │ └────────────┴─────────────────────────────────────────────┴──────┴──────┘ ═══ 7.2. File Browser ═══ ┌────────────┬─────────────────────────────────────────────┐ │CTRL+F │Find string │ ├────────────┼─────────────────────────────────────────────┤ │CTRL+H │Switch to Local Host window │ ├────────────┼─────────────────────────────────────────────┤ │CTRL+O │Browse file │ ├────────────┼─────────────────────────────────────────────┤ │CTRL+P │Print file │ └────────────┴─────────────────────────────────────────────┘ ┌────────────┬─────────────────────────────────────────────┐ │F3 │Close File Browser │ └────────────┴─────────────────────────────────────────────┘ ═══ 7.3. Sendfile ═══ ┌────────────┬────────────────────────────────────────┐ │CTRL+A │Ascii/Binary toggle │ └────────────┴────────────────────────────────────────┘ ═══ 8. Release Information ═══ o Version 2.11 - November, 1995 - Changes o Remote Logon parameters saved by host and userid combination o Remote Logon window host field is initialized with the last host used o Local window will display the local host output directory if one is specified o Added Local Host option to translate outbound file names to lower case o Added Logon settings option to autologon a host or hosts o Added Remote Logon option to connect to server using PASV; 'Firewall-friendly connect' as documented in RFC 1579 - Fixes o Set focus to Local Host window on startup o Handle some non-compliant server responses o SYS3175 in REXX.DLL processing INI file o Version 2.10a - October, 1995 - Fix for 'Unable to Bind Data Socket' on Warp Connect over SLIP/PPP Circumvention for OS/2 APAR ic10390 o Version 2.10 - October, 1995 - First public/shareware release o Version 2.0 - August, 1995 - BETA release o Version 1.0 - VTR, Inc. Internal Release ═══ 9. Support ═══ For technical support, problem reporting or questions about FTP-It!, contact Vantage Technical Resources, Inc. (VTR) e-mail: vtr@airmail.net snail-mail: VTR, Inc. P.O. Box 940473 Plano, Tx. 75074 Please include the versions of FTP-It! and VROBJ.DLL in all communications. To get this information, 1. Start FTP-It! and wait for the Local Host window 2. Press and hold CTRL and press i 3. Record the version numbers for - FTP-It! - FTPIT.DLL - VROBJ.DLL Registered users are guaranteed a response to all communications. Again, thank you for trying FTP-It! ═══ 10. Disclaimer ═══ No warranty of any kind can be given for damage caused through FTP-It! directly or indirectly or any other way. ═══ 11. Trademarks And Copyrights ═══ FTP-It! trademark of Vantage Technical Resources, Inc. OS/2 trademark of International Business Machines Corporation VX-REXX trademark of Watcom International Corporation Info-ZIP Copyright (C) 1989 Samuel H. Smith; All rights reserved Copyright (C) 1992 Igor Mandrichenko Copyright (C) 1994 Greg Roelofs NOTE: FTP-It! is packaged using Info-ZIP's compression utility. UnZip is used to read compressed installation zip files. Info-ZIP's software (Zip, UnZip and related utilities) is free and can be obtained as source code or executables from various bulletin board services and anonymous-ftp sites, including CompuServe's IBMPRO forum and ftp.uu.net:/pub/archiving/zip/*. FTP-It! Copyright (c) 1995 Vantage Technical Resources, Inc.